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RL Monitor Listing Utility Programs 

I 

TIDY , LISTER , and SNOLST 

Since space is limited in RL files, and since people are lazy 
when typing, code typed into RL files is usually very compact and 
unreadable. 

Since the List monitor command prints the source entirely as typed 
in, this procedure will not give you neat listings. Therefore several 
utility programs are provided which help you make neat formatted listings. 

TIDY : 

This program is used to make neat listings of files containing code 
for assembly language programs. It lists the lines with statement labels 
in one column, operands beginning in another column, and comments, if 
any, neatly starting in another column on the far right. RL line numbers 
are also printed on the left hand side of the page. 

TIDY is initiated by the command 

RUN BIN,TIDY=200 

on a tape containing the binary file, TIDY. (The source for TIDY is 
stored in the source files called TIDY0, TIDY1, and TIDY2). 

TIDY will then begin execution. It is ready after the teletype goes 
"kerplunk" twice. At this point, you may either type in a command to 
TIDY or the name of a file to be listed. 

If you type in a file, its name must be 6 characters or less and 
terminated by a carriage return. TIDY will then list the file. If it 
cannot find a file by that name in its catalog in core, it will assume 
that you switched tapes on it and so it will reread the catalog of the 
tape that is then currently mounted. If at this point it still cannot 
find the named file, it will print NOT FOUND and then wait for a new 
file name or command. While TIDY is listing, you can stop the listing 
prematurely by typing any character. 

There are two commands to TIDY: *SYS and *TERM . 

Typing *SY3 tells TIDY to read in a new catalog from the tape. 

*TERM tells TIDY that you are finished listing and it will bootstrap 
by branching to location 7600. 

If at any time while entering a filename or command, you type more than 
six characters and the seventh character is not a carriage return, 

TIDY will type ZAP and ignore your line. There are no other ways to 
correct typing errors. 

TIDY is always restartable at location 200. 

TIDY uses EAE. The user who does not have EAE should be able to remove 
the EAE instructions from TIDY. 

If the user has some high speed printing device, such as a line printer, 
TIDY is easily modified to use this device instead of the teletype. The 
source code for TIDY contains only one output section which can readily 
be rewritten to accommodate any other output device. 
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RL Monitor Listing Utility Programs 


TIDY, LISTER, and SNOLST 


LISTER: 

This is a SNCBOL program which is used to make neat listings of 
assembly language programs for final documentation purposes. It is 
slower than TIDY, but gives page numbering and headings and does 
not list RL line numbers, but attempts to give core addresses for 
where each statement will be loaded during execution time. 

LISTER is run from a tape which contains POLY SNOBOL as a system 
by the command 

RUN SNOBOL.LISTER,file ,file 2 ,...,file^ 

where file^ file 2 , ....file^ are the names of the RL source files 

which contain the program to be listed, n must be less than 15. All 
these source files must be on the same tape as LISTER and POLY SNOBOL. 

The paper in the teletype should be adjusted to the spot where you want 
the listing to start. If you have a model 35 teletype, LISTER will 
eject to the top of a new page when it gets close to the bottom of a 
page. Each new page will contain a heading and these pages will be 
numbered successively. Before starting the program, you can specify 
the heading (title) by typing it into the source file called LISTER. 

The next to the last source statements are statements which you may 
change and which affect your listing. The next to the last source 
statement contains the title which will be printed out on the top of 
each page. The last source statement contains the number which will be 
the first number used when numbering your pages. It must be a two- 
character decimal number. If you want your pages numbered starting 
at page six, this last line should contain a 06 at its beginning. 

SNOLST: 

This is a SNOBOL program which is used to make neat listings of your 
SNOBOL programs. It is similar to LISTER in that it does not list RL 
line numbers and lines your source up into 4 columns- a label field, a 
subject field, an object field, and a goto field. It is run by the 
command 

RTJN SNOBOL,SNOLST,file 1 ,file 2 ,...file n 

LISTIT: 

This program is used to make sort of neat listings of assembly language 
programs. Its source files are called SEND and IT. This program has 
been obsoleted by the program TIDY so is not being distributed through 
DECUS. It is still used at times at the Polytechnic Institute of 
Brooklyn for sentimental reasons. 














